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1.0 IMTHODUCTION 






The tabular display report generator (TABDIS) prograa has been developed as a 
doouaent generaticm tool tiiat provides tabular displays of data stored <m a data 
file has bem generated a user program. The TABDIS prograa provides a 

flexible method of generating document displays. The main features of the pro- 
gram are as follom: 

a. The user specifies (via input) the parameters to appear in each display. 

b. TABDIS requires an input data file in the TRWPLT format. TABDIS user-input 

directives are similar to the TRWPLT input directives. 

c. TABDIS initializes default values for many options so that a user may obtain 
displays with a minimum amount of input or override the default values to do 
detailed design of his otn displays. 

d. TABDIS enables user specification of the symbols to be printed by using the 

symbol record(s) on the input data file. Values of symbols from more than 

one record type (i.e., vehicle number) may be printed in the same display. 

e. TABDIS allows the user to have documentary comments at the beginning of each 
display. 

f. TABDIS allows user specification of the formats of each data value printed. 

g. TABDIS automatically centers symbol headings over each data column. 

h. TABDIS allow the user to determine which data records on the input data 
file are to be displayed. 

i. TABDIS allows for user-defined column headings. If the user does not input 
column headings, the program builds them automatically using the symbol 
names . 

j. TABDIS allows the user to define displays that are printed only if certain 
user-specified data values are found on the data file. These displ&ys are 
referred to as "event” displays. 



i ^ 
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2.0 PBQQMM 


The Inpute to TABDIS ere of tvo types: (Da data file containing the data to 

be displayed and (2) input oards that define the displays to be drawn. The 
basio design of the prograa is to keep the program independent of the program 
that generated ttie data to bd displayed . This concept makes TABDIS usable by 
any piSHPi'n applioation that needs to generate displays of the types which 
TABDIS can pr^uoe. 


The data file fonsat is completely general in nature. The data file can be 
se^ented into files as it is created; for example, each file could be a sepa- 
rate data case in the user program. TABDIS can then build displays from a spe- 
cific file, or display data from several files in the same display. In addition 
to segmenting data by files, the data within a file can be sesoented into differ- 
ent records. For example, a multi vehicle trajectory program could have data rec- 
ords for each vehicle in the same file. Finally, the data file contains rec- 
ords that give a symbolic name to each parameter on the file. These symbolic 
names are then used on the input commands when telling the program what vari- 
ables are to appear in a specific display. For example, the command 


PRINT s A , B 

tells TABDIS to generate a display of the values of variables "A" and "B” from 
the data file. 


The data file structure used by TABDIS is the TRWPLT generalized data file for- 
mat. Complete details of this format are given in section 3*0. This format pro- 
vides a great deal of user flexibility in generating displays with TABDIS or in 
generating plots from the data by using the TRWPLT program. 

The input cards to TABDIS are free-field format and are of the basic form 

SYMBOL = VALUE 

where SYMBOL is a name recognized by the TABDIS input processor. Some of the 
input symbols are keywords recognized by the program and have no value field, 
but most symbols are followed by Integer, real, or character string data. 

Keyword symbols must appear on a card by themselves. Other input cards can con- 
tain several Inputs in the format 

SYMBOL = VALUE , SYMBOL = VALUE 

The user should be able to understand the syntax by simply referring to the 
input examples at the end of each section of the input definition. 

The user is allowed to place comment cards in his input deck. The comments can 
be on a separate card or can follow the Inputs on the same card. The comment 
delimiters available are the asterisk and the apostrophe. The comment delimiter 
must be preceded and followed t.' a blank space. For example, 

SYMBOL = VALUE • COMMENT 
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TAK)IS mkM uac of a generallcod input processor that perforas a detailed 
syntax of eaoh input card and writes out messages for eaoh error encountered. 

Nben an error is found, Uie display to which the input applies is not drawn. 

SeoticMS 2.1 presents a glossary of all the inputs that are given beginning in 
section 2.2. The input sections are presented in the order of simple Inputs 
first and the more oomplex ones in the last seotions. The novice user can gener- 
ate displays by simply using the information given in sections 2.2 and 2.3, 
idiile the advanced user will probably want to use many of the features defined 
beginning in section 2.4. 
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2.1 mjosam v impot vaxukjs 


Swhfti 

AmOTi 

Definition 

Page 

AanotatlOM to b« dispUyeid in a aaquanoa-of-evanta 
display 

2-2T 

ODD 

Additiva fdotora for ttia print Hat variables 

2-22 

OiSAD 

Coltum headiiu(s f<»* ttw oolunna in a display 

2-12 

CtfULT 

Multiplloatlon factors for the print list variables 

2-22 

DELTA 

The display step frequency in tabular displays 

2-21 

ENDDIS 

&nd-of-displsy input indicator 

2-7 

ENDFIL 

File-posltionlr« ccenand 

2-6 

ENDHUN 

gfid-of-run indicator 

2-7 

FORMAT 

Display foraat speoificatim input 

2-14 

EVENT 

Sequence of events definition input 

2-25 

HEADER 

Display header definition 

2-11 

HI 

Highest value to be displayed in a tabular display 

2-21 

IPRINT 

Debug print selection flag 

2-17 

RUNIT 

Data file unit number 

2-6 

LO 

Lowest value to be displayed in a tabular display 

2-21 

MAXCOL 

Maxioim number of ooluoms to allow in a display 

2-17 

MAXLIN 

Maximum number of lines to print on a page 

2-17 

MLINES 

Number of lines required for the next display to be 
printed on the same page as the previous display 

2-17 

NFILES 

Number of files from the data file to be Included 
in the displays 

2-6 

NFIRST 

Record number of the first record to be displayed 
in a tabular display 

2-20 

NFREQ 

Display frequency for records in a tabular display 

2-20 

NOIREC 

Data file format type identifier 

2-6 
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SvbQl Daflnitlen llSC. 

MfflC Nui^«r of rooordo to bo diaployod in • tabular diaplay 2>20 
PRINT Liat of ay^la to bo dlaplayod in a diaplay 2*7 
RBHin) Data filo rowind indloator 2*6 
SKIP Data ^lo akip indicator 2-6 
TITLE Diaplay title dofinitim 2-11 
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2.2 BASIC XKPOTS 

TABDIS hu b«m dMl^td so that uaars o«i gaaarata dlaplaya with a ainiaua nua- 
bMT of i»ar in^t oarda raguii^. ^ia haa haan aooMipliahad by aattii^ aoat of 
tba i^ta to dafault valuaa bafora prooaaaii^ tha uaar input earda. Thia aao- 
tlM ^*aaanta ttoaa inputa Uiat ara naoaaaary for ^naratlng Uia baalo diaplaya 
avallabla in I'ABDIS. Tba aaetlona tiuit follow praaai^ tha inputa that oan ba 
uaad to Mhanoa tha diaplay. Saotim) 2.6 praaanta tha inputa for ganarating 
tdwt ara rafarrad to aa aaquanoa-of-avanta diaplaya that ara vary diffarant rr<» 
tba noraal TATOZS tabular diaplaya. 

Tha axaoutim of tha TABDIS progrM ia invokad by using tha Uni vac EXEC-6 
(Kmtrol oai^ 

• EOT FH6niWPLT.TA6DIS 

This oard is followad by Uia usar input <»rds, idiioh fall into the following two 
gaMral olassifioati«)s: 

a. Data file <K>ntrol inputa - TtMse inputs tell the prograa t^tich file or files 
froa the data file are to be used in generating the displays requested on 
the display ooaaand oards that follow. 

b. Diaplay OMBsnd inputs - These inputs specify what variables are to be shown 
in a given display. 

The final input oard is followed by a oard containing the word ENDRUN, which 
tells TABDIS that no farther displays are required, nils card terminates the 
exeoutioi of the progrw. 
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2.2.1 9i\m Control Innuta 

nt ii^ute pr«Mnt«d h«rt t«U tba progiraa triiiob fiU «f filM froa ttm dau 
flit mr% to bo ttitd in tbo taiMration of ttio Mt of dlaplajra that follow Uiaaa 
i^ta. 


UMIT « n 


NOZREC 


NFILES « n 


Dafinta tha unit mu^r for tha input data fila. nia avail* 
abla unita ara unit nuabara 7 through 29 • 

Ihita flla foraat indicator 

B 0 The data fila oontaina aevaral typea of racorda; 
therefore, Moh variable to be diaplayed Kiat be 
aaaooiated via input wiUi the record identifier nuaber 
for the record type in idiioh the data are located. 

• n The data fila oontaiiw only one type of data record 
with reoord identifier «]ual to n or tiie uaer wiahea 
to ignore all reoorda on the file except those with rec- 
ord identifier equil to n. 

This paraaeter defines the foraat of the PRINT s card 
(sec. 2.3>3) 

Defines the nuaber of files of data to be used froa the 
data file in the generation wf the next set of displays 
(preset to om i . 


TABDIS rewinds the data file after the generation of a display and repositions 
it to the beginning of tiM file that was used to generate the display. In this 
wanner, each display will be generated froa the saae data file or files in the 
data aet until the user changes the file by weans of the Inputs presented below. 


BNDFIL 

REWIND 
SKIP e n 


This card aoves the data file to the next file before 
generatii^ the next display. This input must appear on a 
card by itself. 

This card causes the data file to be rewound. The syabol 
REWIND aust appear by itself on a card. 

Position the file forward free its current position past 
files. SKIP is a fixed point (integer) input. 
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This Motion glToo iM teslo inputs rsquirsd to gonsratt tho sinplost display 
t]^ avsilabla in TABDZS. Ssotiona 2.3 aikl 2.t prsMnt additional inputs that 
oan ba uMd to add titling infm«ation and spaoialia^ fomatting to ustr 
displays. 

PRZIT This ooHMnd spaoifiaa tbs variaMas to ba displayad. Tha 

variablas «*a idantifiad by Uiair plot synbol nsMs. Tlia 
ooMsnd has two foraa, based on the value of NOIftEC. 

NOIREC ■ 0 expacta tha fornat 

PRINT « SYMBOL, ID, SYMBOL, ID 

but if U)a ID field is oaittad, then an ID value of 1 is 

SMUMd. 

NOIRK ■ n requires 

PRINT > SYMBOL, SYMBOL,*** 

where SYMML is the Mriables synbol naae on the dats 
file and ID is the record identifier (sec. 3*0} for the 
data record of the synbola. The syaboln are displayed 
across the display frco left to right in the order in 
which they appear in the PRINT list. 

ENDDIS Identifies the end of the inputs for a specific display. 

ENDRUN Specifies the end of the ;»'ogran execution. 
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2.2.3 Tm.iit rtwmmnAm 

I XQf FN6«TWPLT.TABDXS 

KtWXT ■ 8 * thff input d«U taiit 

N0ZM9C ■ 1 * display data froa raoord typt ■ 1 

P8ZRT > A , B , C , D 
ENDOIS 

NOIREC 9 0 

^ * 

PRINT « A,1,B,1,C,2,D.1 

BNDOIS 

ENDRUN 

Thaaa axr 'las would ^narate displays (in a tabular fora) of avery record on 
tha flla X .talnit^ tba variablaa in tte print list. TtM only haad.ng infoma- 
cion printed would ba the symbol naoa sbova each eoluan of data in the display. 
In the next section wa will present the coaplate foraat of the tabular display 
and present the inputs leaded to obtain titles and headings on the display. 
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2.3 DISPLAY HTLING INPUTS 

The basic TABDIS tabular display format is shown belov. 








1 


1 



I 

OPTIONAL TITLE LINES 

1 



1 


1 








1 


! 



I 

OPTIONAL HEADER LINES 

! 



! 


1 



CHEAD^ 

CHEAD 2 • • • 

CHEADn 



XXX 

• 

XXX 

• 

XXX 

1 


• 

• 

XXX 

• 

• 

XXX 

• 

• 

XXX 



The inputs needed to obtain the titling and heading information are presented as 
follows: 

The user can request display titles, display headings, and column headings by 
means of user Input cards, as defined In this section. These inputs are charac- 
ter string data and as such must be Input In the following format: 

SYMBOL = 'CHARACTER STRING' 

Title and HEADER Inputs have a special card to allow for lines longer than the 
80-column card limit In order to take advantage of the 132-column printer paige 
size. A title or header line longer than 80 columns Is Input on two cards In 
the format 

SYMBOL = 'CHARACTER STRING' 

CONTIN = 'CHARACTER STRING (CONTINUED)' 

Column heading Inputs can be multiline and. In this case, the Input format Is 
SYMBOL = 'CHARACTER STRING - LINE 1' 

, 'CHARACTER STRING - LINE 2' 

If the user wishes the apostrophe ( ' ) to be In a character string he must place 
the character twice In a row on the Input card In the form 
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SYMBOL « 'THE "STRING" TITLE* 
which would yield the string 
THE 'STRING* TITLE 

It should be noted that two apostrophes are not the same as the quote (") char- 
acter. The following sections give the details for inputting titles, headings, 
and column headings. 
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2.3.1 PlflDlav Titlaa and Haadlnga 

Tto dlspli^ titles end headings are printed at the top of tlM display. They are 
printed <»ly on the first page of a multiple-page display. The only real differ- 
enoe between them is that the HEADER input is printed below the TITLE input with 
three blank lines between them. The same effect could be obtained by Inputting 
three blank lines in the title; however, the reason for having both types of 
input is to allow the HEADER to make additional explanatory comments about the 
display that are not really part of its title. Both TITLE and HEADER inputs are 
optional; they can contain as many lines as desired and each line can contain 
one CONTIH card. TABDIS automatically centers the title and header in the 
generated display. Examples of TITLE and HEADER inputs are shown below. 

line 1 /TITLE = ’THIS IS A DISPLAY’ 

ICONTIN = ’OF THE VEHICLE POSITIOH VECTOR’ 

line 2 (TITLE = ’THIS DATA WAS USED TO PE’ 

ICONTIN = ’RFORM INTEGRATION STUDIES’ 


line 1 (HEADER = ’THE (X,Y) POINTS FOI»! TH’ 
ICONTIN = ’E SINE GRAPH’ 

line 2 L^EADER = ’THE (X,2.) POINTS FORM TH’ 
bONTIN = ’E COSINE GRAPH’ 
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2.3.2 Column Haadlna Inputs 

TABDZS places a oolunn heading above each column in the display. This heading 
Is not optional and Is printed at the top of each page of a display. The basic 
font of the CHEAD input card is 

CHEAIXSYMBOL) « 'CHARACTER STRING' 

where SYMBOL is the data file symbol name of the variable, which is one of the 
variables being printed in the current display. If a CHEAD input is not 
specified for a column in the display, the program will use the symbol name as 
the heading. 

Since column headings cannot be extremely long, the program provides for 
multiline column headings, as shown by the following example: 

CHEAD (LAT) = 'VEHICLE' 

, 'LATITUDE' 

This will result in the heading 

VEHICLE 

LATITUDE 

abo’'s' the column in the display containing the data for the symbol LAT. Column 
heaolngs can contain as many lines as desired. 

TABDIS has a method for changing the default column heading from the data file 
symbol to a user-defined symbol of six characters or less. This is done in the 
print list by the syntax 

SYMBOL/LABEL/ 


which changes the default CHEAD value from SYMBOL to LABEL. 
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2.3.3 Eatanplea Ualrut tha Title and Heading Inputs 


TITLE a *GROUNDTRACK DISPUY* 

TITLE a 'MISSION STS>1' 

HEADER a 'VEHICLE QROUNDTRACK' 

CONTIN a 'FOR VEHICLE ONE' 
i PRINT a A,B,C 

{ ! CHEAD (A) = 'TIME' 

, '(GMT)' 

CHEAD (B) a 'LONGITUDE' 

, 'DEG.' 

CHEAD (C) a 'LATITUDE' 

, 'DEG.' 

ENDDIS 

This example would generate a display of the form 


GROUNDTRACK DISPLAY 
MISSION STS-1 


VEHICLE GROUNDTRACK FOR VEHICLE ONE 


TIME 

LONGITUDE 

LATITUDE 

(GMT) 

DEG. 

DEG. 

XXX. XX 
• 

XXX. XX 

XXX. XX 
• 

• 

XXX. XX 

• 

XXX. XX 

• 

• 

XXX. XX 


i 
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2.4 DISPLAY FORMATTING 

TABDIS allows the user to specify the format used to print each column in the 
display. lAien no such inputs are specified by the user, the default format of 
E10.5 is used. The basic form of the FORMAT command is 

FORMAT s • ' 

where the user inserts the desired format or editing code between the 
apostrophes. TABDIS has three basic types of FORMAT commands. 

a. Modification of the default format code. 

b. Specification of the format for one or more symbols in the print list. 

c. Specification of the complete FORMAT statement for the print list. 

Types 1 and 2 can be used in the same display idiere the user uses type 1 to de- 
fine the format used for most of the variables, then uses one or more type-2 for- 
mat commands to define the formats for the remaining variables. 

The format for the first type of FORMAT command is 

FORMAT = ' ’ 

which defines a new default format code to be used on all symbols. The format 
for the second type of FORMAT command is 

FORMAT (SYMBOL) = ’ ' 

which defines a format for the specific symbol. The user can apply the same for- 
mat to several symbols, as follows: 

FORMAT (SYMB0Li,SYMB0L2,*--) = ' ' 

The format for the user-defined FORMAT is 

FORMAT = '( )' 

where the user places the entire format in the string just as would be done in 
coding a Fortran formal- "‘^atement. Certain restrictions apply to the use of 
this option, but these cannot be given until the editing codes available with 
TABDIS formats are explained. After covering the editing codes this document 
will cover the use of user-defined formats in detail. 
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2.4.1 TABDIS Editing Codea 

TABDIS provides the user with a great deal of flexibility in defining the 
editing code to be used in displaying the individual items in a display print 
list. The program uses many of the standard Fortran editing codes plus several 
special codes of its own. Die editing codes available are shown below. 


OSiOa. Syntax Definition 


A 

An 

Display n characters of character data in alphanumeric 
format . 

A 

mAn 

Display m times n characters of character data in 
alphanumeric format. 

DHKS 

I»iMS 

Display a time in the format days: hours iminutes: seconds. 

D 

Om.n 

Display a double-precision value in a field m characters 
wide with n digits to the right of the decimal point. 

E 

Em.n 

Display a slngle-preclslcxi value in a field m characters 
wide with n digits to the right of the decimal point. 

F 

Fm.n 

Display a single-precisicm value in a field m characters 


wide with n digits to the right of the decimal point, but 
with no exponential field as is used with the D and E 
formats . 


HMS 

HMS 

Display time in the format hours: minutes: seconds 


I 

In 

Display an integer value in a field n characters 

wide. 

LAT 

LAT 

Display a latitude position with the north or south indica 
tor present . 

LON 

LON 

Display a longitude position with the east or west 
tor present. 

indica- 

0 

On 

Display a value in octal in a field n characters 

wide. 
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2.4.2 Uaar-Dafln ad Format Raatrlotlona 

The TABDIS user oen define his own display fonoats within the following 
lioltatlons : 

a. The user should not use the apostrophe (') to define Hollerith data but 
should use nH fields. This is because TABDIS uses the apostrophe (') char- 
acter to define the start and atop of string input fields. 

b. With a user-defined fonsat, TABDIS does not perform any data conversion; 
thus, the following restrictions apply: 

(1) Double-precision data cannot be printed 

(2) Integer data cannot be printed unless true integers are on the data 
file. The current form of the TABDIS automatic mode converts data to 
integer if requested. 

(3) String fields can be printed if they consist of <mly one data word on 
the file or if each word on the file is listed in the print list. The 
automatic mode can print a string with only the first word in the print 
list by using the A-POIMAT. 

c. The nonnal column heading input cannot be used because the program will not 
know where the data columns will be placed. HEADER cards could be used to 
build the headings, or the user can input a complete column heading by the 
input format 

CHEAD = '( )• 

which is of the same syntax as the user-defined FORMAT input. 

d. If annotations are desired in a user format, it would be simpler to place 
the annotation data in nH fields in the format instead of trying to use A6 
fields. 



I In tiM aatoBatio forantting node, TiffiDIS ooaputns th« number of character poai- 

I tions required for a dlaplay and then uses the remainder of apacea available to 

place apacea between the varioua itema in the print line Thia logic tenda to 
center the diaplay on the page, nie following inputa can modify the final ap- 
pearance of a dlaplay. 

MAXCOL « n Thia input reducea the number of colvunna uaed on a line 

from the atandard 132 to a uaer-deflned value. The program 
will then center ita diaplay in the n diaraoter poaitiona 
available to it . Thia la uaed for generating page-aize dia- 
playa and diaplaya on CRT acreena. 

MAXLIH X n Thia input define; the number of linea to be uaed on a 

page. The default value ia 56. 

MLINES = n Thia input ia uaed only with aequence-of-eventa diaplaya. 

It deflnea the number of linea to be uaed by the next dia- 
play where the program will place the dlaplay on the page 
with the previoua diaplay if apace ia available. 

IPRINT X 1 Thia ia a debug-only option. It printa the format atate- 

ment created by TABDIS for the diaplay linea along with the 
format for the column headinga. It ia uaed when trying to 
aacertain idiy a diaplay did not come out aa expected. 
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2.4.4 Qf PoraattlM Inputs 

Tiw axuplM b«lotr illuatr»t« the TABDIS foraetting Inputs dsflned in the prevl> 
oue seotlone. 


PRINT « A , B , C 

PORHAT « 'E20.8* * use E20.8 on all variables 

BNDDIS 


PRUT > A , B , C 

FORMAT s 'B20.8* * define default fomat as E20.8 
FORMAT(B) ■ 'F10.2* * input a specific format for B 
ENDDIS 


PRINT s A B f C 

FORHAT(A,C) s 'E20.8' * define formats for A and C 

FOmAT(B) « *E15.5* • define fonnat for B 

ENDDIS 


PRUT s A , B , C 

FORMAT a '(10 x,E 15.6,2X,2E20.5)' • user-defined format 

CHEAD a •(15X,1HA,l6X,1riB,l4X,1HO* • user-defined CHEAD 


ENDDIS 




PRINT a A , B/LABEL/ , C 

• the 

default 

CHEAD will be 

ENDDIS 

• A 

LABEL 

C 
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2.5 MTA SELECTION INPUTS 

Hh«i TABDIS Bets vp a data file in preparation for drawing a tabular display, 
all data records in the file or files selaoted are printed in the display. ‘Die 
inputs in this aeotion give the user the ability to generate a display using 
only a nibset of Uie data reoords. Additional inputs are provided in this sec- 
tiM) that allow the user to modify the data by adding a constant to each value 
or multiplying each value by a constant. 
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2.5.1 Data Salaotion bv Raoord Counting 

OtM Method of reducing the number of lines In a tabular display la to spnolfy 
!.he records to be displayed by using the following Inputs: 

NPIRST B n The record nunber of the first record to be included in the 

display. 

NREC ■ n The number of records to be included in the display. 

NFRI^ s n Use only every nth record in the display. 

The default value of each of these values is zero. The defaults have the follow- 
ing meanings: 

HPIRST Start with the first data record. 

NREC Use all records in the file or flies selected by NPILES. 

NPREQ Use every data record. 
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2.5.2 D»t« a«l*Qtlon bv D«f V«ly 

TImm ln^t« funotiOD tlailar to tho rooord counting inputs, but allow the usor 
to dofino tho storting Mid ending points of tho display in toros of dots vsluoa 
rathor than rooord oount. 

LO ■ SYMBOL, ID, VALUE Defines tho starting value of tho display. 

The prograa will skip all data records until 
the value of SYHTOL crosses the user-specified 
value. Tho crossing can be froa above or 
below. 

HI s SYMB(H., ID, VALUE Defines tho end value of the display. When 

the program reaches the record idiere the 
value of SYH^L crosses th^ specified value 
frc»D either above or below, the display is 
terminated. 


DELTA B SYMBOL, ID, VALUE This input allows the user to display a 

subset of the records. The program will 
keep track of the value of the symbol at a 
display point, atwl will not display a record 
again until a value is reached that is the 
specified delta away from the last printed 
record . 


These inputs must be relnput for each display desired. The user does not have 
to use all of them, but may use any that he wishes to obtain his display. 


eoFHije 


2 . 5.3 V>lu« Modlfleation Input* 

Th«M In^ts tmbl« tb« uMr to aodify the date to be displayed. This capabil- 
ity la priaarily i»ed to perfora units inversion on the displays or to refer- 
enoe values froa a speoifio value in a display. The basic equation used is 

C I CHULT • VALUE 4 CADD 

Nbere 

C • The value displayed 

CADD s An input value added to the data value (defaulted to 0.0) 

CMILT • A value aultiplied by the data value (defaulted to 1.0) 

VALIA s The data value froa the data file 

The user inputs required to exercise this capability are as follows: 

CADD « V^ • ^2> ^n Defines the addition factor for each column 

of the display; i.e., for each print list 
variable. 

CMULT « , V 2 V„ Defines the nultlplicatlon factor for each 

print variable. 

These inputs carry over froa one display to the next and should be reset to zero 
when they are longer required. When the print list contains annotations 
(sec. 2.6.2) they Bust be counted in deteralning the relation between a position 
in the CADD and Q1ULT arrays and the variables to which they apply. Because the 
annotation logic will ignore its CADD and CMULT values, any value can be input 
for these positions in the CADD at^ OiULT lists. 
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2.5.4 Pxamplea Ualng the Data Seleetlon Inouta 

Tlie following exaoplea are given aa illustrations of the data selection inputs. 


NFIRST s 5 
NFRBQ s 2 
NREC a 10 
PRINT s A , E 
ENDDIS 


* Begin the display with record 5. 

* Display every other record. 

* Display a total of 10 records. 


NOIREC s 1 

LO = ALPHA , 10.0 


HI = ALPHA, 20.0 

PRINT s A , B , C 
ENDDIS 

CADD = 1.0,0.0,1 .0 

PRINT = A , B , C 
ENDDIS 


* Begin the display when a record 

* is found with ALPHA greater than J 

* or equal to 10.0. Notice that 

* a record ID is not needed with the 

* NOIREC input. 

* Terminate the display when ALPHA 

* reaches 20.0. 


* Add 1.0 to each value of A and C 

• in the display. 
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2.6 SEQUENCE-OF-EVBNTS DISPLAYS 

In addition to the standard tabular display format available in TABDIS, the pro- 
gram has an alternate display type, which is referred to as a sequence-of-events 
display. These displays are similar to the tabular format except for the follow' 
ing: 


a. Each line printed in the display is requested by the user defining a spe- 
cific event condition. 

b. The display line usually contains certain explanatory Information defining 
the event. This input is called an annotation. 

c. The complete display can have many different event conditions, with separate 
PRINT lists and FORMAT inputs for each line. 

The program has provisions for the following two basic types of sequence-of- 
events displays: 

a. Several events nrinted in the same display. 

b. Several print lines at a single event. 

The following pages give the detailed inputs necessary to obtain sequence-of- 
events displays. 
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2.6.1 The EVEHT Card Structure 

The EVSIT card is used to defiiM the condition upon which a display PRINT line 
ia to be printed. The fonaat of the EVENT card is as follows: 

EVENT « SYMBOL (ID) , VALUE , FLAG , TOL , ALL 

where 

SYMBOL s The variable nane of the variable upon which the condition is 
based. 

(ID) = The record ID, vrtiich is used only if NOIREC = 0. If NOIREC = 0 and 
the ID is not present, a value of 1 is assumed. 

VALUE s The value of the variable that defines the desired event. 

FLAG = An indicator that defines what condition is to be met by the value at 
the event point. 

EQ = Equality. 

NE = Not equal to. 

GT = The value of the variable crosses the specified value going in 
the upward direction. 

GE = The value of the variable crosses or reaches the specified 
value going in an upward direction. 

LT = The value of the variable crosses the specified value going in 
a downward direction. 

LE = The value of the variable crosses or reaches the specified 
value going in a downward direction. 

TOL = An optional tolerance used in testing for the satisfying of an event 

condition. This is used as follows: Let V be a value from the data 

file. The program then uses V + TOL and V - TOL as an interval 
to test for the meeting of the condition. Users should be aware that 
a tolerance of exactly zero could result in a failure on an EQ test be- 
cause of numerical roundoff; thus, a small tolerance is advisable even 
on EQ events. 

ALL = An optional field which indicates that this event occurs several times 
on the file and each is to be displayed . Without the ALL symbol , only 
the first occurrence will be displayed. 

A second EVENT card format exists for a special condition called a double- 
equality event. The card format is 

EVENT = (SYMBOL(ID), VALUE, SYMBOL, VALUE, UNIQUE) 

where 
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SYHBOL( ID) VALUE s Specifies two conditions that are to be met by exact equal- 
ity. These conditions should be Integer data or alpha- 
numeric data where the equality will not have numerical 
problems. Notice that only one record ID is allowed. 

Both symbols must be from the same data file record. 

UNIQUE s This is an optional field that allows the user to define several 
events with the exact condition. This is similar to the ALL type 
logic on the normal event input except that in this case each event 
desired must have another EVENT card with the same condition. The 
first EVENT card will be matched with the first data file record 
found that satisfies the condition specified on the EVENT card. The 
second EVENT card will be paired with the second occurrence of the 
condition, etc. Different annotation inputs may be used on the dif- 
ferent events. 
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2.6.2 fiygnt Annotationa 

Tn a display, event annotations allow the user to Include line data that is not 
on Uie data file. The foraat of the annotation input card is similar to TITLE 
and CHBAD cards. The inputs are character string data in the fcrm 

AMNOT]^ = 'CHARACTER STRING* 

t^re 1 s 1, 2, or 3. The annotations can have continuation cards Just as with 
CHEAD inputs. 

Up to three annotations are allowed, and their placement on the page is deter- 
mined by their position in the PRINT = list. CHEAD Inputs are required for the 
annotations used in order to obtain the heading above the annotation column. 
Annotations normally do not require FX)RMAT cards. Exceptions are made in cer- 
tain cases with multiple-print lines at a single event, which will be 
considered later in this section. 

Annotations are used Instead of A-PORMAT data from the data file for the follow- 
ing two main reasons: 

a. To modify the description without having to re-create the data file. 

b. To provide multiline annotations whereas the A-FORMAT data are only single- 
line outputs. 

The annotations and A-FORMAT alternatives for event displays will have to be de- 
cided upon by each user's application. They each have advantages in certain 
situations. 
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2.6.3 Hiltiple Event Dlaolava 


The format of thla event dieplay allows multiple events to be shown in the same 
display, but allows only tme print list. The outline of the input cards is 
shown below. 


TITLE = 

HEADER > 

EVENT s 
PRINT 3 
ANNOTj^ 3 
CHEAP 3 
EVENT 3 I 

/ inputs for event 2 

ANNOTj = ) 

EVENT 3 ) 

( inputs for event 3 

ANNCXTj^ 3 ) 


ENDDIS 

The lines will be displayed in the order in vdiich they are located as the pro- 
gram reads down the data file. If two or more events are found in the same data 
record, they will be printed in the order that they are input. Notice that the 
ANNOTjl cards follow the event card to which they apply. 
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The format of this event display allows only a single event in the display, but 
allows several print statements with their own formats and annotations. The 
outline of the input card sequence is shown below. 


TITLE s 
EVENT 8 
PRINT 8 
CHEAD 8 
FORMAT = 
ANNOTj^ 8 


Inputs for the first print line and titles 


PRINT = 
FORMAT = 
ANNOTi = 
PRINT = 
FORMAT = 
ANNOTi = 


inputs for the second print line 


inputs for the third print line 


PRINT = \ 

FORMAT = > inputs for the last print line 

ANNOTi = / 

ENDDIS 

FORMAT specifications are optional on each print list in the display. If CHEAD 
input is used, then the CHEAD( ) cards should r>"fer to the first print list. No- 
tice that the PRINT = card begins the inputs for each new print line after the 
first print line. 

The lines in this type of display are printed in the order that they are input. 
The annotation inputs are used to label each line cf the display. Consider the 
following example: 
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TITLE > 'COHOITIONS AT ENTRY* 
CHEAP (ANNOT1) = 'DEFINITION* 
CHEAP (TIME) s 'VALUE* 

PRINT > ANNOT1 , TIME 
ANNOT1 s 'TIME* 

PRINT s ANNOT1 , HD 
ANNOT1 s 'ALTITUDE* 

ENDDIS 


The display would have the form 



CONDITIONS AT ENTRY 




DEFINITION 

VALUE 



TIME 

xxxx.xx 



ALTITUDE 

xxxx.xx 



If the user attempts to run the above example, the display might not come out 
with the various lines of the display properly alined. This is caused by one of 
the following reasons: 

a. Annotations of various lengths. 

b. The user changes the FORMAT specifications from one print list to the next. 

c. The user changes the number of print list items from one print line to the 
next. 

Some of these problems can be reworked to produce a properly alined display. 

The user can input his annotations with the same length by adding blank charac- 
ters on the end, or he can input a card of the form 

FORMAT (ANNOTi) = An 

which reserves n character positions for the annotation column where n is 
greater than or equal to the longest annotation line. 

When the user changes FORMAT specifications on a multiple print list event dis- 
play, he must remember the following: 

a. If he does not specify a format for some items in the ^^int list, then the 
default format will be used for those items. 

b. If ue specifies formats of different lengths in different print lists, this 
could shift the print columns out of proper alinement. 
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2.6.5 Event Input Exanplea 

The examples below Illustrate the two basic forms of the sequence-of-events 
display. 

TITLE = 'SEQUENCE OF EVENTS DISPLAY' 

EVENT s X , 10.0 , GT * event with no tolerance input 

PRINT r X , Y , THETA 

EVENT s X , 20.0 , GT , 0.001 * event with a tolerance input 

ENDDIS 

TITLE = 'TITLE' 

EVENT = X, 25.0 , EQ , 0.01 
PRINT = ANN0T1 , X 
ANNOT1 = 'X - VALUE' 

PRINT s ANN0T1 , Y 
ANN0T1 = 'Y - VALUE' 

ENDDIS 
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2.7 INPUT CARD ORDERING RULES 

A f«w rul«a relating to input card ordering were mentioned In the preceding sec- 
tions of this dooument. ITiey are being repeated here as a reference for the ben- 
efit of the program users. 

a. Cards micb as TITLE, HEADER, QlEAD, and FORMAT, vriiich can have several cards 
of input, must have all their input cards in consecutive order. 

TITLE > 

TITLE B is legal 

PRINT > 

TITLE « 

PRINT s is not legal 

TITLE = 

b. Cards for CHEAD and FORMAT must follow the PRINT card because they reference 
the print list variable names that must be known by the program prior to 
their being referenced. 

PRINT = A 

FORMAT(A) B is legal 

CHEAD(A) B 

CHEAD(A) s la not legal 

PRINT s A 

c. In sequence-of-event displays with multiple events In a display, the EVENT 
card begins the inputs for each new event; therefore, all Its data cards 
must follow this card. 

d. For sequence-of-event displays with one event and multiple print lists, the 
PRINT card begins the inputs for each print line in the display; therefore, 
all other data cards referring to a specific print line must follow this 
card. 
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3.0 mt HLB TOBMAT 

Tht format of the data file used by TABDIS has been designed to be compatible 
with Uie generalized nature of the program. The format allows the file to con- 
tain data from different Murces as well as data generated at varying 
frequenoies of the same independent variable. 

Baoh record on the file contains a record identifier that associates it with a 
particular data souroe. For iAStanoe, a multlvehicle trajectory program might 
associate eaoh record with a particular vehicle. The record identifier is 
apeoifled as a lawber (such as 1, 2, or 3, etc.), and that sane number is used 
on the user input commands to reference the desired record type. In the case 
where only one data souroe is present on the file, TABDIS is given this fact on 
an input card and the user does not have to put record identification numbers on 
any of his TABDIS omsands. 

The format of each record of tlM data file is as follows: 

IREC, M, DATA^, DATA 2 ,,, DkTk^ 
where 

IREC s The record identification number. 

N X The number of variables in the data set for this record. 

DATA X The data values for this record. 

In the user program, the data records should be written with a nonformatted 
WRITE statement; for example 

WRITE (7) IREC, N,(DATA(I), 1=1, N) 

After all records have been written onto the file that the user desires in a spe- 
cific file of the data file, he should close the file with the Fortran end-of- 
file command DID FILE. The file can have as many files of data as the user 
desires. On the Unlvac EXEC-8 system, the data can be written to either a disk 
file or to magnetic tape. 

TABDIS requires the user to identify each data item in each record by a symbolic 
name. This symbolic name is then to be used in identifying the variable on all 
display commands which must reference that variable. The data file must contain 
a symbol record for each record type on the file. The format of the symbol rec- 
ord is 

JREC, N, SYMBOL,, SYMBOLj,,, SYMBOL^, 
idjere 
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«IHEC * 

N B Th« miBber of nyabols in thla record. 

SnsOL B The symbols for each variable in this record type. Ihe symbols are 
each one fieldata word of up to six characters and are left* 
Justified and blank-filled to the right. 

The symbol records for all record types in a file must be the first records 
written on each file of the data file. 
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H.O SAliPLE OUTPUT DISPLAM 

The TABDIS run presented in this section iUustrstes K>st of the cspsbllities of 
the TABOZS pre^rss. 
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EVCNT DISPLAY WITH MULTIPLC r’»INT LISTS 
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. 17000*00 

. 11000*03 

-. 00700*00 

. 70000*00 

. 10000*00 

. 11700*01 

-. 00770*00 

. 00901*00 

. I 0 *» 00*00 

. 11700*01 

-. 70170*00 

. 07030*00 

. 10000*00 

. 11000*01 

-. 30011*00 

. 00077*00 

. 10000*00 

. 110 *» 0*01 

-. 07070*00 

. 90000*00 

. 10000*00 

. 1 * 1000*01 

-. 10017*00 

. 99011 *00 

. 00000*00 

. 17100*01 

-. 71101-00 

. 10000*01 

. 00 * 100*00 

. 17100*01 

. 10031*00 

. 09010*00 
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OISPLAV NUHtCII •• • SCOOCNCC Of CVCMIS OI5Pt»* 



i 









♦ 
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eiin.«T NWHMN t - cvCMT oim*r mitn miint list* 


OCtCRI^TION 
•r VALUC 

> • VALUC 

T • VALUC 

• • VALUC 

RCCORO NUHICH 


VALUC 

.{•••••OS 

.9ta«s*ac 

.C0l«0*0I 


oitPkAv NWNKii • - tcouCNCC or C'^CNTt etm«T 


mce 




IMC 


lttO«*QS 


I 

. tsaao » tt ' 

. I 0900 » 0 > 
.t9900»0« 
.7«900*et 


t 

.tff«ea*o« 
.• iiooo*ai 
. I t•••»ea 
. lOIOOtOt 


BItaLAV MURBCA • - fiCOUtNCC Of CVCNTf OltRLAT 
SCCONO Dim AT ON A OAOC 


I 

.99090*et 
. 10900*0* 
.79900*00 


I 

. 00000*01 
.«»0000*0l 
. 10000*00 


btmcta 

.0l7<l0*00 

.90090*00 

•.91900*00 

•.0C770-0I 


ITHCTA 

.O17H0*00 

.00090*00 

•.00770-0I 


4>lb 


OISPLAV NUHICII 7 • HPCATINO CVCNT OISPLAV 


mcc 

thcta 

otncta 

• 

' .113000*00 

.70977096*00 

• 

.00000*00 

.70175330*00 

10 

.060*10*00 

.53500639*00 

II 

.00030*00 

.90770780*00 

•II 

.00133*01 

.90778700*00 


.00761*01 

.53580808*00 

7> 

.06360*01 

.78175589*00 

<l>l 

.07010*01 

.70578167*00 

100 

.67030*01 

.70577006*00 

109 

.67050*01 

.78177659*00 

no 

.60H07*OI 

.53501989*00 

III 

.60115*01 

.50777056*00 

in 

.07087*ai 

.58779701*00 

IH8 

.06503*01 

.53583603*00 

IH3 

.09001*01 

. 78176355*00 

111 

.098H9*0I 

.70578957*00 
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CNO-or-riLC on plot unit. 

rOLLOHINO CVCNTS UCRC NOT ON PLOT TILC. 
CVCNT • 1 
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OISPLAV NO. • 


USCN 

OCriNCO rORHAT 

.31715096*01 


. 100001 *01 

-. 100000*01 

UtCR 

DCriNCD rORHAT 

. 32672532*01 


.7<*t3HO*00 

-.992115*00 

USER 

ocriNCo roRHAT 

. 33929168*01 


.S02627*00 

-.968587*00 

UtCR 

OCriNCO rORHAT 

. 35185803*01 


.2637S7*00 

-.929778*00 

UtCR 

OCriNCO FORMAT 

. 36772739*01 


.3tHg09-0l 

-.876308*00 

UtCR 

OCriNCD FORMAT 

. 37699075*01 


-.175565*00 

-.809019*00 

UtCR 

OCFINED FORMAT 

. 3895571 1*01 


- . 369089*00 

-.729971*00 

UtCR 

OCFINCO FORMAT 

.70870667*01 


-.618029*00 

-.587789*00 

UtCR 

OCFINCO FORMAT 

.72725617*01 


- .809650*00 

-.725783*00 

UtCR 

OCFINCO FORMAT 

.77123870*01 


- . 100000*01 

-.799787-05 

UtCR 

OCFINCO FORMAT 

.51522063*01 


-.809659*00 

.725777*00 

USER 

OCFINCO FORMAT 

.53707016*01 


-.6I80<«I*00 

.587780*00 

UtCR 

OCFINCO FORMAT 

. 55291969*01 


-.369103*00 

.726967*00 

USCR 

OCFINCO FORMAT 

.56576607*01 


-. 175581 *00 

.809013*00 

USER 

OCFINCO FORMAT 

.57605239*01 


. 36H81 1 -01 

. 876307*00 

USCR 

OCFINCO FORMAT 

.59061877*01 


.263738*00 

, 929777*00 

USCR 

OCFINCO format 

.60318509*01 


.502607*00 

. 968581 *00 

USCR 

OCFINCO FORMAT 

.61575175*01 


.779319*00 

.9921 17*00 

USCR 

OCFINCO FORMAT 

. 62631760*01 


.999985*00 

. 100000*01 

USCR 

OCFINCO FORMAT 

.67088715*01 


. 125065*01 

.9921 16*00 
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DIS)>LAy NUHBCR • - SEOUCNCC Or EVENTS DISPLAY 


MECORO 
t • 

NO. 

IS. 

2 

• 

.2200*0ITHCTA> 

.637H2)**00 

RECORD 
X • 

NO. 

C2. 

.10300000*02 

2 

• 

.H200*OIThETA* 

.968303*00 

RECORD 
X ■ 

NO. 

SO. 

.29300000*02 

2 

• 

. 1 IS0*02THETA> 

'.33Se2>»*00 

RECORD 
X > 

NO. 

132. 

2 

• 

. 3020*02TNETA« 

-.OBTYO't-Ol 
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DISPLAY NUHDCR 10 • SCQUCNCC OF CVCNTS DISPLAY 


RCCORD 
K > 

NO. 

10 . 

.98000000*01 

2 • 

.2200*OIThCTA- 

.S37>*2‘**00 

RCCORD 
« • 

NO. 

22 . 

.10900000*02 

Z > 

.H200*0ITHCTA« 

.960983*00 

RCCORD 

X « 

NO. 

SO. 

.29900000*02 

Z « 

. t IO0*02THCTA> 

-.93S82H*00 

RCCDRD 
X ■ 

NO. 

192. 

.79900000*02 

Z ■ 

. 3020*02ThCTA* 

-.62778'*-OI 


NASA JSC 
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